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About This Document 

This dcxument is the reiease note for the H P DCE/9000 Version 1.6 (H P 
DCE 1.6) Appiication DeveiopmentTooisfor HP-UX 10.30. 
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What's I n This Version 


The HP DCE Version 1.6 Application Development Tools for HP-UX 
10.30 help users to develop HP DCE 1.6 applications. 
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What's In This Version 

Application Development Tools Product Options 


Application Development Tools Product 
Options 

The HP DCE Version 1.6 Application Development Tools for HP-UX 
10.30 consists of two optional products. 

The licenses you have purchased from Hewlett-Packard determine 
whether you can install either or both products. The two optional 
products are: 

• HP DCE Application Development Tools (the DCE-C-Tools 
product) assist in the development of H P DCE programs written in C. 
The HP DCE-C-Tools include: 

/ HP DCE Version 1.6 Messaging and Serviceability I nterfaces 
/ I2DL Compiler 
/ Sample Applications 


NOTE Although Tracing, Logging and Error Reporting facilities of the previous 

versions are still available in this version of H P DCE-C Tools, HP 
recommends that you usethe new Messaging and Serviceability 
I nterfaces. 


< HP Object Oriented DCE (OODCE) Application Development 
Tools (the DCE-OO-Tools product) assist development of H P DCE 
object-oriented programs written in C-H-. TheHP DCE-00 Tools 
include: 

/ idl-H-Compiler 
/ Tracing and Logging facility 
/ C-H-Cl ass Library 
/ Includefiles 
/ Sample Applications 


8 


HP DCE/9000V. 1.6 Application Development Tools Release Note 




What's In This Version 

New Features 


New Features 

There are no new features in the HP DCE 1.6 Application Development 
Tools for HP-UX 10.30. 
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What's In This Version 

New Features 
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Known Problems and VUbrk 
Arounds 


This section describes known probiems in the HP DCE Version 1.6 
Appiication DeveiopmentTooisfor HP-UX 10.30. 
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Known Problems and WorkArounds 

DCE-CoreTools 


DCE-CoreTools 

In DCE 1.6theDCE_SVC_DEBUG macro has been changed to acquire 
a SVC mutex lock (in prior releases this was done in the serviceability 
library). Because of this, DCE applications based on DCE 1.5 and earlier 
releases that makeuseof this macro will be binary incompatible with 
DCE 1.6 applications and so must be recompiled under DCE 1.6 on 
HP-UX 10.30. 
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Known Problems and WorkArounds 

DCE-C-Tools 


DCE-C-Tools 

There are no problems in H P DCE-C-Tools discovered at H P DCE 1.5 or 
1 . 6 . 
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Known Problems and WorkArounds 

DCE-OO-Tools 


DCE-OO-Tools 

The following problems and work arounds in HP DCE-OO-Tools, 

documented at H P DCE 1.4.1 and 1.5, are also applicable at this version: 

• You should minimize your application's dependencies on protected 
and private members and member functions as their features may 
change in a future release. 

• When using C-H-to develop DCE applications, you should adhere to 
the foil owing advice: 

/ Do not enable cancellation of a thread. 

/ Do not allow DCE exceptions to propagate into a C-H-scope 
without appropriate DCE-to-C-H-mapping. 

/ Install both the C and C-H-compilers because the DCE 

communications stub files-which must be compiIed-are generated 
in C. 

/ Ensure that the correct libraries and flags are being used for 
compiling the application. 


NOTE For more information, see HP OODCE Product Notes in theonline help 

system. 


There are no additional problems in HP DCE-OO-Tools discovered at HP 
DCE 1.6. 
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Compatibility Information and 
Installation Requirements 


This section provides a brief overview of the instaiiation process for the 
HP DCE Version 1.6Appiication DeveiopmentTooisfor HP-UX 10.30 
and the software prerequisites and disk space requirements that must be 
met before you can instaii the software. 
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Compatibility Information and Installation Requirements 

Overview 


Overview 

The following is a brief overview of the installation process: 

1. Verify that your site meets the hardware and software prerequisites 
described in the following subsections. 

2. U se the swcopy tool to load HP DC E/9000 (Version 1.6) Application 
Development Tools software from the media to the same network 
distribution area that contains the HP DCE/9000 Core Services 
release software. 

3. Usetheswinstall tool to install either (or both) DCE-C-Tools and 
DCE-00-Tools on individual systems. 

Depending on which license(s) you have purchased from 

Hewlett-Packard, you can install either or both of thefilesetsfromthe 

distribution media. 
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Compatibility Information and Installation Requirements 

Prerequisites 


Prerequisites 

The prerequisites for installation of DCE Version 1.6 Application 
Development Tools for H P-UX 10.30 are: 

DCE-C-Tools 

• H P Series 800 Computer 

• HP-UX 10.30 release, including the foil owing fi I esets: 

/ DCE-Core.DCE-CORE-RUN 

/ DCE-Core.DCE-CORE-SHLIB 
/ DCE-CoreTools.DCE-BPRG 

The first twofilesets listed are included with the H P-UX 10.30 Core 
OS media. The last fileset is included with the H P-UX 10.30 
Application Release media. (At HP-UX 10.20 and previous releases, it 
was part of the Core OS.) 

• At least 2 Mbytes (2,000 Kbytes) of available disk space to 
accommodate the fi I esets of the HP DC E-C-Tools product you will be 
installing: 

/ DCE-C-Tools (HP DCE C Application Tools) 

/ DCE-TOOLS-LIB (HP DCE Programming Libraries) 

DCE-OO-Tools 

• H P Series 800 Computer 

• HP-UX 10.30 release, including the foil owing fi I esets: 

/ DCE-Core.DCE-RUN 

/ DCE-Core.DCE-CORE-SHLIB 
/ DCE-CoreTools.DCE-BPRG 

The first twofilesets listed are included with the H P-UX 10.30 Core 
OS media. The last fileset is included with the H P-UX 10.30 
Application Release media. (At HP-UX 10.20 and previous releases, it 
was part of the Core OS.) 
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Compatibility Information and Installation Requirements 

Prerequisites 


• H P C++Compiler (Version A.10.11) 

• H P C Compiler (Version A.10.30) 

• The DCE-C-Tools Programming Libraries fiIeset, DCE-TOOLS-LIB 

• At least 5 Mbytes (5,000 Kbytes) of available disk space to 
accommodate the fi I esets of the HP-DCE-00-Tools product you will 
be installing: 

/ DCE-OO-HELP (HP OODCE Online Help) 

/ DCE-OO-TOOLS (HP OODCE Application Tools) 

NOTE The H P DDE debugger is highly recommended for multithreaded 

debugging support. 
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What's Fixed In This Version 


This section describes bug fixes in the H P DCE Version 1.6 Appiication 
DeveiopmentTooisfor HP-UX 10.30. 
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What's Fixed In This Version 

DCE-C-Tools 


DCE-C-Tools 

No major fixes were made at H P DCE Version 1.6. 


NOTE Refer to the READM E notes associated with each sample application for 

minor changes in that application. 
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What's Fixed In This Version 

DCE-OO-Tools 


DCE-OO-Tools 

The following fixes were made at HP DCE Version 1.4.1: 

• Fixed DCEServer class symbols uniqueand multipleby renaming the 
DCEHostPolicy enum members unique to DCE unique and multiple 
to DCEmultipleto avoid conflict with similar names used in 
customer's code. 

• Fixed support for DCEHostPolicy DCEmultiplethat allows the 
I i brary to register server i nterfaces by cal I i ng the 
rpc_ep_register_no_replace() function instead of the rpc_ep_register() 
function, thereby allowing multiple servers to have their endpoints 
registered at the same time and with the same UUID on the same 
machine. 

• Fixed the runtime object table to allow more than 99 objects in a 
server. 

• Fixed a number of memory corruption problems when using the CDS. 

• No longer uses the RogueWave Tempi ate library, thereby avoiding 
incompatibility with applications using a different version of the 
library. 

• Previously, the C++runtime libraries shipped with the C++compiler 
were not thread safe and did not support exception handling with the 
shared libraries. Now, theC++runtime libraries shipped with Version 
A.10.03 (or higher) of the C++compiler are thread safe and support 
exception handling with shared libraries. 

No major fixes were made at H P DCE Version 1.6. 
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What's Fixed In This Version 

DCE-OO-Tools 
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What Manuals Are Available For 
This Version 


Describes the dcxiumentation available for the HP DCE Version 1.6 
Application Development Tools for HP-UX 10.30. 
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What Manuals Are Available ForThis Version 

Printed Documentation 


Printed Documentation 

The printed dcxumentation for the Application Development Tools 
consists of the following: 

• This document, which describes both the DCE-C-Tools and 
DCE-00-Tools products. 

• The NCS 1.5.1 to DCE RPC Transition Guide (part number 
B3193-9002), which is shipped with DCE-C-Tools. 

All other documentation for these products is availableonlineonly; you 
can print the online files through the standard help and man page print 
functions. 
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What Manuals Are Available ForThis Version 

Online Documentation 


Online Documentation 

DCE-C-Tcx>ls 

DCE-C-Tcxols includes the following online documentation: 

• The following CDE Help volumes: 

/ HP DCE Application De/elopment Tools (access to man pages) 

/ HP SampleApplicationsOnlineHelp 

To access these volumes, select HP DCE Application Development 
Tools from the CDE Front Panel. 

• HP DCE Version 1.6 Application Development Tools ReleaseNote, a 
preliminary version of this document 

• Man pages 

NOTE To access these man pages from the HP Help System, include the 

directory /usr/share/man in your MANPATH environment variable. 

NOTE Refer also to the ASCI I README file included in the directory of each of 

the sample applications for important information about that 
application. 

DCE-OO-Tools 

DC E -00-Tool s I ncl udes the fol I owi ng on I i ne docu mentat i on: 

• The following CDE volumes: 

/ HP OODCE Product Notes 

/ HP OODCE Application Development Tools 

/ HP OODCE Cl ass Library Reference (access to man pages) 

/ HP OODCE Sample Applications 

To access these help volumes, select HP OODCE Application 
Development Tools from the CDE Front Panel. 
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NOTE 


What Manuals Are Available ForThis Version 

Online Documentation 


• HP DCE Version 1.6 Application Da/dopmentTools RdeaseNote, a 
preliminary version of this document 

• The following manual, provided in PostScript format only: HP Object 
Oriented DCE C++Class Library Programmer's Guide 

(/opt/dce/shar e/h ptool s/doc/oodce/user s_gd .ps) 

• Man pages 

To access the HP 00DCE man pages from the H P Help System, include 
the di rectory /opt/dce/share/usr/man in your MAN PATH environment 
variable. 

To access all HP DCE man pages, add the following directories to your 
MAN PATH variable: 

/opt/dce/share/man 

/opt/dce/usr/man 

/usr/share/man 
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Software Availability in Native 
Languages 


TheHP DCE 1.6 Application Development Tools for HP-UX 10.30 are 
currently available in English only. 
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Software Availability in Native Languages 
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Developing DCE Applications 
with HP DCE/9000 


This chapter provides information about developing, building, and 
debugging DCE applications with HP DCE/9000. 

The HP DCE application development software, including the IDL 
compiler, the NI DL-to-l DL translator, DCE interface definition files and 
header files, the I nternational version of the DCE archive library, and 
the pthreads archive library, may not be included in the H P-UX bundle 
that you installed. If you intend to develop HP DCE applications, you 
must explicitly install any software that you require. 


HP DCE/9000 V 1.6 Application Development Tools Release Note 29 



Developing DCE Applications with HP DCE/ 9000 

Building DCE Programs 


Building DCE Programs 


NOTE Hewlett-Packard supports only the ANSI C compiler for building 

HP DCE applications. Hewlett-Packard cannot provide support for 
problems with HP DCE applications not compiled using ANSI C.This 
restriction also applies to applications on HP-UX 10.x systems built 
using the HP-UX user-space threads library (libcma). 


When compiling and linking H P DCE applications, note the foil owing: 

• I n order for the correct header file contents to be used, define 
_HPUX_SOURCE when compiling your HP DCE application: 

-D_HPUX_SOURCE. 

• You mustdefine_REENTRANTand_PTHREADS_DRAFT4when 

compiling HP DCE programs for the following reasons: 

/ Toensurethat thethreadsafe routines such as putc, putchar, 
getc, and get char are used instead of the non-thread-safe macro 
versions defined in stdio.h. 

/ To get definitions of new structures and to provide ANSI C 
prototype information for the new reentrant interfaces. 

• Ifyou include <^jth read.h>, you must do so before other header files 
in your C source file. Also note that <qjthread.h> defines 

_REENTRANT. 

• Source code that is built into applications that use the CDS, RPC, or 
security APIs must include <qjthread.h>. This is necessary because 
the DCE RPC runtime library creates a small number of private 
threads, on both the client and server sides of an application. 

• The DCE header files should be included as <dce/header.h>. Because 
names of some of the DCE header files conflict with those in 
-/usr/include, you should avoid using the -l/usr/include/dceC 
preprocessor option to include DCE header files. 

• DCE applications must always link with libdce. When linked with 
other libraries, libdce must be linked first, as follows: 

-Idee <other_libraries> 

Do not link in libc explicitly when building a DCE application. 
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Developing DCE Applications with HP DCE/ 9000 

Building DCE Programs 


• If you link in libdce, libcma is automatically linked in; if you are 
using libcma without libdce, you must link libcma first, as follows: 

-Icma <other_libraries> 

• libdce and libc must be either both shared or both archived library 
versions; a mixed environment with one of the libraries the shared 
version and the other the archived version is not supported. 

• libcma and libc must be either both shared or both archived library 
versions; a mixed environment with one of the libraries the shared 
version and the other the archived version is not supported. 
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Developing DCE Applications with HP DCE/ 9000 

Notes on Debugging HP DCE Applications 


Notes on Debugging HP DCE 
Applications 

The foil owing are tips on debugging HP DCE applications. Also see 
Programming with Threads on H P-UX (B2355-90060) for additional 
information about debugging HP DCE Applications. 

• To debug an HP DCE threads application with DDE, use the 
-dce_thread option. By default, DDE assumes that the application is 
single- or kernel-threaded. 

The debug and dde commands have been extended to take the 
-dce_thread option. For example: 

debug -dce_thread average 
dde -dce_thread average 

See Section 3.2.1 (DDE) of the H P-UX Programming Tools Release 
Notes (part number 5965-4409) and the dde man page for more 
information about the -dce_thread option. 

• HP DCE uses the HP-UX SIGCHLD andSIGVTALRM signals 
internally. When debugging H P DCE servers or clients, you must 
ensure that these signals, when received, are passed along to the 
target process. If you are using DDE or xdb, you can modify your 
debugger start-up files as follows: 

“Adderc: 

alias'after debug [del int signal SI GCHLD;del int signal 
SIGVTALRM] 

“Axdbrc: 

z 18 rs #do not stop or report SI GCH LD 
z 20 rs #do not stop or report SI GVTALRM 

See Programming with Threads on H P-UX and the discussion of 
-signalO in this chapter for more information on the use of signals 
with HP DCE applications. 

• Be sure the application has an exception handler installed that can 
field any RPC exceptions. 
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Developing DCE Applications with HP DCE/ 9000 

Notes on Debugging HP DCE Applications 


• Run the server side of your application under the debugger so that 
exceptions raised in server code will trap into the debugger rather 
than being reflected back to the client process via RPC. This makes it 
easier to identify bugs in the server that might otherwise appear to be 
client bugs. 

See the README file and server_debug.ksh script in 
/opt/dce/sharei/hpexamples/string conv for information on 
debugging "deed-started" servers via xdb or dde. 
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Developing DCE Applications with HP DCE/ 9000 

Using HP DCE with C++ Appiications 


Using HP DCE with C++Applications 

If you want to use C++with either standard DCE or H P's OODCE to 
create DCE applications, there are some practices you must avoid. Most 
of these relate to lack of thread-safeness of C-E+operations. 

The following list describes the practices you should avoid. These 
guidelines apply to H P C-E+compiler version A.3.70 and later. 

By taking these precautions, you should beableto productively useC-E+ 
or OODCE to write DCE applications. 

• When using unsafe constructs, besure to use the constructs in only 
one thread at a time. 

• DCE CM A exceptions should never be allowed to propagate i nto a 
C-E+scope. Allowing this to happen could result in destructors failing 
to be executed. This can lead to memory leaks and unexpected 
behavior. For example, suppose some C-H-code makes a call to a C 
function. Within this C function, a CMA exception can be raised. It is 
very important that the CM A exception also be caught within theC 
function. If it is not, then the CMA exception could propagate into the 
C-H-environment, resulting in unexpected behavior. 

A DCE exception can also be caught in a C-H-routine which has called 
a DCE function. You must be sure that there are no memory 
allocations within the TRY block (note that some conversions cause 
memory allocation): 

TRY { call a function which might do a DCE RAISE } 

CATCH_ALL { handle it but don’t RERAISE } 

ENDTRY 

Note that some library calls, and most system calls, are CMA 
cancellation points, and must be wrapp^ as described here. 

• Do not enable cancellation of a thread that is running C-H-code. 
Asynchronous cancellation may cause a DCE exception to be raised at 
anytime. Synchronous cancellation may cause a DCE exception to be 
raised any time a system routine is executed. 

• The following item applies only when programming DCE applications 
using C-H-and standard DCE; it does not apply when programming 
with OODCE: 
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Developing DCE Applications with HP DCE/ 9000 

Using HP DCE with C++ Appiications 


Do not use C++exceptions in multi-threaded processes, including 
DCE servers and managers. The stack unwinding that occurs when a 
C-E+except!on is raised is not guaranteed to work in the presence of 
multiple RPC threads. 


HP DCE/9000 V 1.6 Application Development Tools Release Note 


35 




Developing DCE Applications with HP DCE/ 9000 

Notes on Programming with HP DCE 


Notes on Programming with HP DCE 

The foil owing are miscellaneous notes on programming with HP DCE. 
Also see Programming with Threads on HP-UX (B2355-90060). 

Several features of interest to programmers will not be supported at the 
next release of HP DCE, including support for the rdaclif routines for 
ACL managers. You should also be aware of future changes to threads 
support. For details, see "Features Changing at the Next Release" in 
Chapter 1 of Planning and Configuring H P DCE 1.6. 

Appropriate Usesof theCell Directory Service 

The Cel I Directory Service (CDS) was designed for a specific purpose: to 
store and retrieve server bindings in a DCE cell. This mission implies 
numerous assumptions about the volume of information that must be 
stored and about the types and frequency of access to that information. 
Performance trade-offs in CDS's usage of memory, disk, cache, the 
network, and time-outs are optimized to this very specialized purpose. 

The generality of the application programming interfaces to CDS masks 
the specificity of this purpose, and gives CDS the appearance of a 
general-purpose database system. It is not; the optimizations of CDS for 
its low-volume and weakly-replicated storage, and for retrieval of server 
bindings in a fairly static name space, are rarely optimal for other 
purposes. Moreover, other uses of CDS directly compete and interfere 
with its use and availability as a critical core component of the DCE 
system. 

Application developers are frequently tempted to use CDS for the direct 
storage of information other than server bindings. For example, the 
developer of a telephone number directory service may consider using 
CDS to store the information directly. This is a bad idea, as the volume of 
information could overwhelm the in-memory CDS data structures, and 
very frequent read accesses could slow CDS performance and lock out 
DCE server lookup requests. A much better strategy would be to 
implement a database server designed specifically for the telephone 
number directory service, and then store the bindings of that server in 
CDS for lookup by clients. I n this way, other uses do not compromise 
CDS in its intended use as a critical DCE component. 
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Developing DCE Applications with HP DCE/ 9000 

Notes on Programming with HP DCE 


Cell Directory Service Programming 
I nterfaces 

The supported programming interfaces to CDS are the RPC Name 
Service I ndependent (RPC_NS) interface and the X/Open Directory 
Service (XDS) interface. The RPC_NS function call prototypes are in the 
include file/usr/include/dce/rpc.h. TheXDS function call prototypes 
are in the include file/ usr/includei^ds.h. The RPC_NS interface is the 
procedural interface used by the core DCE components and most 
applications. TheXDS interface is an object-oriented interface 
appropriate for use with other X/Open standards such asX.500. Both the 
RPC_NS and XDS interfaces support many common name space 
functions, but lack administrative capabilities such as the ability to 
create and delete directories and manage replication. 

dcecp is the recommended tool for performing CDS administrative 
functions such as creating and deleting directories and managing 
replication, dcecp can be called in a shell script, but is not a 
programming interface. 

RPC_RESTRICTED_PORTS Environment 
Variable 

The capability to restrict the assignment of endpoints to those in a 
user-specified set was added to RPC in OSF DCE 1.0.3. This allows DCE 
applications to operate in environments in which inter-network traffic is 
restricted to specified endpoints. The facility is activated by setting the 
RPC_RESTRICTED_PORTS environment variable with the list of end 
points to which dynamic assignment should derestricted before starting 
an RPC application. RPC_RESTRICTED_PORTS governs only the 
dynamic assignment of server and client ports by the RPC runtime. It 
does not affect well-known endpoints. 

The facility is turned on by setting the RPC_RESTRICTED_PORTS 
environment variable before starting an RPC application. The syntax of 
the variable is as follows: 

<entry>[COLON <entry>]* 

<entry>: <protseq_name>LEFT-BRACKET <ranges> 
RIGHT-BRACKET 

<ranges>: <range>[COMMA <range>]* 

<range>: <endpoint-low>HYPH EN <endpoint-high> 

For example: 
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Developing DCE Applications with HP DCE/ 9000 

Notes on Programming with HP DCE 


ncacn_ip_tcp[5000-5110,5500-5521]:ncadg_ip_udp[6500-7000] 

To use RPC_RESTRICTED_PORTS for DCE itself, set the environment 
variable before starting your cell. The environment variable must beset 
whenever you restart DCE. 

Note that this facility does not add any security to RPC and is not 
intended as a security feature. It merely facilitates configuring a network 
"fire wall" to allow incoming calls to DCE servers. 

RPC Authentication 

TheOSF DCE Application De/elopment Guide and the OSF DCE 
Application De/elopment Reference may be misleading about what 
happens when an unauthenticated client calls a server that has specified 
authentication. I n such a case, the RPC runtime will not perform any 
authentication, and the cal I will either reach the server manager code, or 
be rejected by the runtime, depending on the following conditions: 

• If the client specified no authentication, then none is attempted by 
the RPC runtime. The call reaches the manager code whether the 
server specified authentication or not. This permits both 
authenticated and unauthenticated clients to call authenticated 
servers. When the manager receives an unauthenticated call, it must 
make a decision about how to proceed. 

• If the client specified DCE secret key authentication and the server 
specified no authentication, then the runtime will reject the call, and 
it will never reach the manager routine. 

• If both client and server specified DCE secret key authentication, 
then authentication will be carried out by the RPC runtime 
transparently. Whether the cal I reaches the server manager code or is 
rejected by the runtime will depend on whether the authentication 
succeeds. 

Although the RPC runtime is responsible for any authentication that 
is carried out, the fact that the runtime will always permit 
unauthenticated clients to reach the manager code means that a 
manager access function typically does need to make an 
authentication check. When the manager access routine calls 
rpc_bindingjnq_auth_client(), it should check for a return status 
of rpc_s_binding_has_no_auth. When such a status is returned, it 
means that the client has specified no authentication, and the 
manager access function will have to make an access decision based 
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onthisfact. Note that in such a case, no meaningful authentication or 
authorization information is returned from 

r pcbi ndi ngj nqauthcli ent(). 

RPC Data Transfer Limitation 

The bulk data transfer (for example, I N/OUT-pipes) over the 
connection-oriented (TCP/IP) RPC protocol is limited by the performance 
difference between the client and server machines. If the receiver process 
is significantly slower than the sender process (and cannot process data 
fast enough), the receiver process's virtual memory usage may grow 
rapidly until the remote procedure cal I fails with an rpc_s_no_memory 
status. 

Restricting RPC Addresses 

The runtime looks for a RPC_SUPPORTED_NETADDRS environment 
variable, which allows a user or administrator to restrict the network 
addresses that a DCE server will advertise in the name 
space/endpoi nt-map. 

If this environment variable is set, only addresses in the list will be 
advertised in the name space or endpoint map. Addresses not found on 
the list will be excluded from the server's list of available addresses. 

The format of the RPC_SUPPORTED_NETADDRS string is as follows: 

RPC_SUPPORTED_NETADDRS=protseq:netaddr[,protseq:netaddr] 

For example, assuming that host myhost is located at IP address 

10.3.2.1, the Korn shell statements: 

export RPC_SUPPORTED_NETADDRS=ip:myhost 

or 

export RPC_SUPPORTED_NETADDRS=ip:10.3.2.1 

will force any servers started in the current shell to support only the 
addresses associated with the name myhost and the network address 

10.3.2.1. 

Calling execQ from a DCE Application 

Care must be used when callingexecO from a DCE application. H P DCE 
Threads sometimes sets open file descriptors to non-blocking mode, so 
that I/O calls block only the calling thread, not the entire process. This 
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cxccurs unbeknownst to the application itself. H P provides wrappers for 
the execO fami ly of cal Is that, among other thi ngs, resets file descri ptors 
to blocking modeif they were set non-blocking by HP DCE Threads and 
not the application. 

For file descriptors that were inherited across fork(), this also has the 
effect of resetting the file descriptor to blocking mode in the parent as 
well as the child. If the parent is a threaded program, it can cause the 
parent to hang due to a blocking I/O call. 

There are two possible work-arounds: 

• If the process will not need the open file descriptor, set the 
close-on-exec flag for the file prior tocallingexecO. The file descriptor 
will not be reset in this case. 

• Avoid using the execO wrapper; call exec() directly instead. This is 
accomplished by undefining the appropriate macro, for example: 
#undef execle. 

Notethat if the execO wrapper is circumvented, the new process may 
inherit file descriptors that are unexpectedly set non-blocking; some 
signals may be unexpectedly ignored or not ignored; and, if execO is 
called without first cal ling forkO, the new process will probably be killed 
by SIGVTALRM as soon as it begins execution. 

Process Forking 

Process forking from within RPC applications that use the 
connection-oriented (TCP/I P) RPC protocol is not supported. 

While it is generally safe for an application to perform a fork followed 
immediately by an execO, the following sequence may not work for 
TCP/IP RPC programs: 

• The TCP/I P RPC process forks. 

• Thechild processtriestouseRPC overtheTCP/IP protocol beforethe 

exec(). 

Process forking from within RPC applications that use the 
connectionless protocol (U DP/IP) is supported, with the following 
restrictions: 

• For client-side applications, the U DP/I P protocol isforksafe. It isthe 
responsibility of the application developer to ensure that all other 
application threads are capable of crossing forks safely. 
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• On the server side, the only supported behavior is for a server thread 
to fork and exec, with no use of RPC in the child of the fork until after 
the exec. 

File Locking 

The H P DCE Threads fcntl() wrapper does not provide for 
thread-synchronous file locking. The entire process will block when a call 
tofcntl() specifies F_SETLKW and thefile is currently locked by another 
process. 

Note also that HP-UX file locks are a process-wide resource. For this 
reason, if multiple threads call fcntl() to lock the same section of a file, 
all the calls will succeed, and each thread will believe it holds the lock. 
However, only a single, process-wide lock is actually obtained — the first 
call obtains the lock, the second and subsequent calls have no effect. If 
one thread releases this lock, the other threads will continue to believe 
thefile is locked, when in fact the process no longer holds any lock on 
that section of thefile. 

Use mutex locks to ensure that only one thread at a time locks a 
particular file or section of a file. 

The previous comments regarding file locking with fcntl() also apply to 
lockfO. lockfO is not wrapped by DCE Threads. 

sec_i d_parse_name() 


CAUTION I n previous H P DCE releases, the sec_id_parse_name() library call 

could be passed a NULL pointer or null string for the global principal 
name and would return the local cell name. This behavior is maintained 
in HP DCE 1.6, but will not be supported InfutureHP DCE releases. 
Instead, pass to obtain this result. 


sec_logi rival i d_and_cert_i dent() 

The sec_login_valid_and_cert_ident() routine uses fcntl() for file 
locking, and should not be called by more than one thread at a time. If 
you must usesec_login_valid_and_cert_ident() in multi pie threads, 
usea mutex to insure that only one thread at a time executes the call. No 
HP DCE programming interfaces call 
see logiri valid and eert ident() i nternal Iy. 
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Applications that need to obtain credentials in multi pie threads will 
generally only need to call sec_login_validate_identity(), which is not 
affected by fcntl(). 

semopO 

The H P DCE Threads semopO will not increment the semncnt or 
semzcnt kernel variables. Because the semopO wrapper adds the 
I PC_NOWAIT option before performing the semopO system call, the 
valueof semncnt and semzcnt should not be trusted when using semopO 
to perform semaphore operations. 

signal 0 

Use of the signal!) system call is not supported by HP DCE Threads, as 
it can interfere with signal handlers that are installed by Threads. In 
some cases, you can retain signal!) calls in legacy code as follows: 

• I mplement a wrapper for signal!) that calls sigaction!) or 
- sigwait!). 

• Use signal!) itself to install a handler for a signal, provided the 
signal is not SIGVTALRM, SIGCHLD, or SIGSYS, and provided no 
thread installs a handler for the signal with sigaction!) or waits for 
the signal with sigwait!). 

systemO 

The H P DCE Threads system!) wrapper does not block SIGCH LD. It 
does set the handler for SIGQUIT and SIGI NT to SIG_IGN, but only for 
the calling thread. This behavior differs from the behavior of the 
standard HP-UX version of system!). 

vforkO 

The HP DCE Threads vfork!) wrapper cannot be circumvented. The 
methods used to circumvent other wrappers !defining 
_CM A_NOWRAPPERS_, undefining vfork, defining vfork to be 
_vfork_sys) do not work. 
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